==================================================
= Melissa Name Object API for Windows
==================================================

Prerequisite
====================
This sample is intended for use after the installation of Name Object. It requires that 
the Name Object is registered and the Data Files installed. If you did not install the Data Files
to its default directory, you will have to change the Data File Path in the sample code to point it
to the correct directory. The Data Files Directory must contain the following files: mdName.dat and
mdName.cfg.

Demo Mode
===============
Please contact your sales representative to obtain a free 30-day license to use Name Object.  After
30 days, the Object must be purchased before continued usage. Please call 1-800-MELISSA ext. 3 for
more information.

C++/Windows Sample Programs
===========================
The sample programs can be built with most C/C++ compilers. This sample has been tested with 
Visual Studio 2005 C++ compiler. 

Setup
=====
You must copy over the necessary files in order to compile and run. Copy from your Name Object library
directory the following files to this directory:

	mdName.h
	mdName.dll
	mdName.lib

Compiling
=========
To compile this sample, you can use the makefile provided. For Visual Studio, you must run 
VCVARS32.bat (located in your Visual studio bin directory) and then run nmake. 

Linking to the C++ Library
==========================
Note that some non-Microsoft compilers are unable to link to the C++ classes.
This is due to differences in the way different compilers link to C++
functions (also known as "Name Decoration"). The most practical workaround to
this problem is to use the standard C mdName functions instead.

Missing DLL
===========
If you get an "Unable to Locate Component" Windows message referring to
mdName.dll, it is most likely because Windows cannot find mdName.dll. The
easiest solution is to add the file's location to your PATH environment 
variable or copy mdName.dll into the current (.exe's) folder.
